home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / database / ezdata / readme.txt < prev    next >
Encoding:
Text File  |  1995-06-30  |  11.4 KB  |  326 lines
  1. ==========================================================
  2. =                             =    
  3. =                      EZDATA             =
  4. =                             =    
  5. =    Copyright Leigh Business Enterprises Ltd.        =
  6. =            100444.623@compuserve.com                =
  7. =                             =    
  8. ==========================================================
  9.  
  10.  
  11.  
  12. "The fastest way to create your next VB database application"
  13.  
  14.  
  15.  
  16.  
  17. ==========================================================
  18.             CONTENTS
  19. ==========================================================
  20. Introduction
  21. Files in the Demo
  22. Features
  23. Using EZDATA
  24. Registering
  25. Distributing Applications built with EZDATA
  26. Description of forms/modules
  27. Disclaimer
  28. Advertisement
  29.  
  30.  
  31. ==========================================================
  32.             INTRODUCTION
  33. ==========================================================
  34. This is a complete MDI Application 'skeleton' with
  35. an easy to implement tabbed data editor which will help you
  36. to get your next project off the ground even quicker.  
  37.  
  38. It's called EzData because it has been designed to make the 
  39. management of most data tables to be straightforward.  Just call
  40. the EditDbase function with the name of the table that you
  41. want your users to maintain and everything is done for you.
  42. Users can search for particular data (using partial strings
  43. if required) and the records which matches their search 
  44. parameters are clearly displayed in a listbox - making it 
  45. easy to select and view the required one.
  46.  
  47. Our code manages the creation of the search dialog and the
  48. display of the data.  It also manages all updates  when the 
  49. user makes changes, adds or deletes records AND allows 
  50. hooks to your own validation routine before saving.
  51.  
  52. For a full description see the section entitled "Description of 
  53. forms/modules".
  54.  
  55. Best of all - you get the source code.  So you can adapt our
  56. routines to exactly match your requirements.  
  57.  
  58. The source code is well structured and there are plenty of 
  59. comments to guide you through.  If you need more  information 
  60. or have a query then we are very happy to take questions 
  61. from registered users.
  62.  
  63. ==========================================================
  64.         FILES IN THE DEMO
  65. ==========================================================
  66. The demo consists of the following files:
  67.  
  68. ezdata.exe     - the demo
  69. toolbar.bmp     - the bitmap for the toolbar icons
  70. readme.txt     - this text
  71. code.zip     - the encrypted zip file containing the source code
  72. Demo.mdb     - the sample database
  73.  
  74. When you register we will send you the password and instructions
  75. needed to unlock all the forms and code that make up this demo.
  76.  
  77.  
  78. ==========================================================
  79.             FEATURES
  80. ==========================================================
  81. * Single command to edit/add/delete/search database records
  82. * Selection of application database.
  83. * Compact/Repair of database.
  84. * Helptips' on toolbar items (optional).
  85. * Support for Help files.
  86. * MDI child forms tiling etc.
  87. * Comprehensive error trapping and reporting
  88. * 'Nag' screen support for shareware authors.
  89. * Support for 3D dialogs (switched off in design mode
  90.   to prevent GPFs)
  91. * Memorise window position and size.
  92.  
  93.  
  94.  
  95.  
  96. ==========================================================
  97.             USING EZDATA
  98. ==========================================================
  99. You need VB Pro to use EZDATA, although it could be
  100. modified to run under the standard edition.
  101.  
  102. Create your project directory, copy all the files supplied
  103. into that directory and rename ezdata.mak to your new 
  104. project name.
  105.  
  106. You will need to set up some information in APP.BAS (app name
  107. etc.), particularly in SetAppInfo().  You will also need to add
  108. your own application specific code in APP.BAS.
  109.  
  110. Alternatively you could just add fEdDbase.frm, Database.bas,
  111. Error.bas, fDummy.frm, ListBox.bas, PerfTab.bas, String.bas, 
  112. fValidat.bas and System.bas to your existing project.
  113.  
  114.  
  115.  
  116. ==========================================================
  117.             REGISTERING
  118. ==========================================================
  119. Registration costs just US$12. When you register you get
  120. the password to unlock the complete source code.
  121. The simplest way to register is to do it on-line via
  122. SWREG by typing GO SWREG. Select "Register", then select 
  123. "Registration ID" and quote Program Id 6337.  Your account 
  124. will be debited the registration fee.
  125.  
  126. As soon as CompuServe notifies us of your registration 
  127. we will e-mail you the password and further instructions.
  128.  
  129.  
  130. ==========================================================
  131.        DISTRIBUTING APPLICATIONS BUILT USING EZDATA
  132. ==========================================================
  133. As a registered user there is no restriction on you
  134. distributing executable programs which have been built
  135. using this source code.
  136.  
  137. This application incorporates some ideas/code from
  138. other programmers if they have not placed a limitation
  139. on their distribution.  These are acknowledged where
  140. appropriate.
  141.  
  142. Distribution of source code is a difficult point.
  143. We would frown upon widespread distribution of the
  144. source code for profit by others.  However we
  145. recognise that some users will need to distribute
  146. the source code of a bespoke application and would
  147. not wish to limit you in such a case.
  148.  
  149. We hope that you will find it useful.  If you wish to
  150. discuss it then please e-mail us on Compuserve 100444,623.
  151.  
  152.  
  153. ==========================================================
  154.         DESCRIPTION OF FORMS/MODULES
  155. ==========================================================
  156. FABOUT.FRM <No need for you to edit this>
  157. This form is the standard About box.
  158.  
  159. FDUMMY.FRM <No need for you to edit this>
  160. This form is used by the error handler.
  161.  
  162. FEDDBASE.FRM <No need for you to edit this>
  163. Everything is handled for you automatically in this form.
  164. Just specify the table and it will allow add/editing/deleting 
  165. of records , presenting the data to the user via a
  166. list box.
  167.  
  168. The user is presented with two tab-cards.  The first
  169. shows a list box filled with data from the specified
  170. column of your table.  The second card allows the
  171. user to specify search and matching criteria which
  172. will limit the displayed records.
  173.  
  174. Whilst data is being added to the listbox the user can
  175. stop the process and perhaps set search criteria to
  176. select the data they are interested in.
  177.  
  178. If the amount of retrieved data exceeds the limits of the
  179. list box, the user is informed and can adjust the
  180. retrieval criteria.
  181.  
  182. It will not display (or allow editing) of any auto-
  183. incrementing fields (i.e. the Counter datatype commonly
  184. used as a key in Access databases).
  185.  
  186. In addition, if you have set up your the table such that
  187. instead of deleting records, they are simply marked as
  188. deleted then it will automatically do this for you when
  189. the user deletes a record.  To implement this the
  190. column used to flag the record as deleted must be of type
  191. Boolean and must have the string "DELETE" in its name (case
  192. insensitive).
  193.  
  194. FVALIDATE.FRM <Change this for your own validation>
  195. This form is used to hold validation routines for
  196. database saves.
  197.  
  198. When the fEdDbase form is about to do a save, it
  199. changes the text controls on this form:
  200.  
  201. It sets txtTable to the name of the table being
  202. edited and txtFields to a tab-separated list of the
  203. field values that have been entered and need to be
  204. validated.
  205.  
  206. To validate the values, put your own code in the
  207. changed event of the txtFields object with a
  208. Case statement for each txtTable that your
  209. app uses.
  210.  
  211. If you make any changes to the text in txtFields
  212. these will automatically be reflected in the editing form.
  213. For example if you put the following in the 
  214. Changed event:
  215.   txtFields.Text = UCase(txtFields.Text)
  216. then all your data will be saved in upper case.
  217.  
  218. If you wish to CANCEL the save then just set the
  219. txtFields.Text to ""
  220.  
  221. FUSAGE.FRM <No need for you to edit this>
  222. This form is the standard 'nag' screen so beloved of
  223. shareware authors.  It is displayed automatically if
  224. you set a global flag.
  225.  
  226. MDIMAIN.FRM <You will need to change this for your app>
  227. The main application mdi form.
  228.  
  229. APP.BAS <You will need to change this for your app>
  230. This file should be used to implement code specific to your application.
  231.  
  232. SetAppInfo        - required global info about your app
  233. bValidDbase       - whatever your test for a valid database is
  234. CreateAppDbase    - code to create your app's database
  235. ToolbarActon      - define what actions your toolbar does
  236.  
  237. CONSTANT.BAS <No need for you to edit this>
  238. Required constant declarations.
  239.  
  240.  
  241. CTL3D.BAS <No need for you to edit this>
  242. Implements 3d dialogs.
  243.  
  244. Ctl3d_start      - begin using 3d dialogs
  245. Ctl3d_end      - Quit using 3d dialogs
  246. DoesCtl3DExist      - check for Ctl3Dv2.Dll
  247.  
  248. DATABASE.BAS <No need for you to edit this>
  249. Contains functions used in database operations.
  250.  
  251. ERROR.BAS <No need for you to edit this>
  252. This module manages error handling.
  253.  
  254. FILEXIST.BAS <No need for you to edit this>
  255. This module contains only one function - which is
  256. to test for the existence of a file.
  257.  
  258. FORMS.BAS <No need for you to edit this>
  259. This module contains functions to manage forms.
  260.  
  261. HELPTIP.BAS <No need for you to edit this>
  262. Contains a single function to manage the toolbar helptips.
  263.  
  264. LISTBOX.BAS <No need for you to edit this>
  265. This contains functions related to listboxes.
  266.  
  267. MAIN.BAS <No need for you to edit this>
  268. Manages the application framework.  Main() must be called
  269. as the startup routine.
  270.  
  271. PERFTAB.BAS <No need for you to edit this>
  272. This is an implementation of PerfectTAB 1.0  which is Freeware,
  273. Copyright "bytes & letters"' hilger software technology,
  274. postfach 16 27, 66716 Saarlouis, Germany.  No charge is made
  275. for inclusion of this piece of code.  It is included as an
  276. example of the many ways available of implementing tabbed
  277. dialogs.
  278.  
  279. STRING.BAS <No need for you to edit this>
  280. Contains string handling functions.
  281.  
  282. SYSTEM.BAS <No need for you to edit this>
  283. Contains system related functions.
  284.  
  285. ==========================================================
  286.             DISCLAIMER
  287. ==========================================================
  288. Although we have taken every reasonable effort to ensure
  289. the quality of the code, we cannot be held responsible for
  290. any consequences following its use, nor warranty its fitness
  291. for purpose.
  292.  
  293.  
  294. ==========================================================
  295.             ADVERTISEMENT!
  296. ==========================================================
  297. Are you looking for a helpdesk system? Or does your company
  298. want to track and monitor the progress of any work activity?
  299. We market a system which could be of interest to you:
  300.  
  301. PROGRESS Features
  302. -----------------
  303. * Maintain customer address and contact details.
  304. * Classify jobs into categories.
  305. * Transfer of jobs between users.
  306. * Full audit trail of what actions were taken and by whom.
  307. * Prioritisation of jobs.
  308. * Specify target completion dates.
  309. * Real-time monitoring of all jobs with optional alarm.
  310. * Flexible querying tool to report and monitor on all jobs or only those
  311.   jobs which meet a particular set of criteria.
  312. * Sort jobs according to customer, logged date, target date, priority etc.
  313. * Flexible reports: Jobs per Category, Jobs per Customer,
  314.   Overdue vs On-target, Frequency of jobs etc.
  315. * Multiple jobs databases - so you could maintain one for help-desk, one
  316.   for orders etc.
  317. * Full, on-line, context sensitive help.
  318.  
  319. PROGRESS is available for download from the Business section
  320. of the Windows Shareware forum on Compuserve.  GO WINSHARE then
  321. Search using our Contributor ID of 100444,623.
  322.  
  323.  
  324.  
  325.  
  326.